<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>
<html xmlns='http://www.w3.org/1999/xhtml'>
<head>
<title>tests/README</title>
<meta name='robots' content='noindex,nofollow' />
<meta name='generator' content='GLOBAL-6.5.7' />
<meta http-equiv='Content-Style-Type' content='text/css' />
<link rel='stylesheet' type='text/css' href='../style.css' />
</head>
<body>
<!-- beginning of fixed guide -->
<div id='guide'><ul>
<li><a href='#TOP'><img class='icon' src='../icons/first.png' alt='[^]' /></a></li>
<li><a href='#BOTTOM'><img class='icon' src='../icons/last.png' alt='[v]' /></a></li>
<li><a href='#TOP'><img class='icon' src='../icons/top.png' alt='[top]' /></a></li>
<li><a href='#BOTTOM'><img class='icon' src='../icons/bottom.png' alt='[bottom]' /></a></li>
<li><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a></li>
<li><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a></li>
<li class='standout'><span><a href='../files/tests.html'>tests</a>/README</span></li>
</ul></div>
<!-- end of fixed guide -->
<a id='TOP' name='TOP'></a><h2 class='header'><a href='../mains.html'>root</a>/<a href='../files/tests.html'>tests</a>/README</h2>
<em class='comment'>/* <img class='icon' src='../icons/n_left.png' alt='[previous]' /><img class='icon' src='../icons/n_right.png' alt='[next]' /><img class='icon' src='../icons/n_first.png' alt='[first]' /><img class='icon' src='../icons/n_last.png' alt='[last]' /><img class='icon' src='../icons/n_top.png' alt='[top]' /><a href='#BOTTOM'><img class='icon' src='../icons/bottom.png' alt='[bottom]' /></a><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a>&nbsp;<input type='text' readonly onfocus='this.select();' value='+1 tests/README'  /> */</em>
<hr />
<pre>
<a id='L1' name='L1'></a>Overview
<a id='L2' name='L2'></a>--------
<a id='L3' name='L3'></a> 
<a id='L4' name='L4'></a>This tree contains unit tests.
<a id='L5' name='L5'></a> 
<a id='L6' name='L6'></a>To compile and run the tests, do 'make check' (either in the top folder,
<a id='L7' name='L7'></a>or just in the folder containing the tests you're interested in).
<a id='L8' name='L8'></a> 
<a id='L9' name='L9'></a>IMPORTANT: To compile the tests, you need to have the "Check" unit
<a id='L10' name='L10'></a>testing framework[1] installed.[2] If you have it installed, you will see
<a id='L11' name='L11'></a>"Unit tests: yes" in configure's summary message; if you don't see this
<a id='L12' name='L12'></a>message, you won't be able to compile the tests.[3]
<a id='L13' name='L13'></a> 
<a id='L14' name='L14'></a>Tips and tricks
<a id='L15' name='L15'></a>---------------
<a id='L16' name='L16'></a> 
<a id='L17' name='L17'></a>* To be able to step with the debugger into test code, see [4]. E.g., do:
<a id='L18' name='L18'></a> 
<a id='L19' name='L19'></a>    $ export CK_FORK=no
<a id='L20' name='L20'></a> 
<a id='L21' name='L21'></a>[1]: http://libcheck.github.io/check/
<a id='L22' name='L22'></a>[2]: Your package manager likely has it.
<a id='L23' name='L23'></a>[3]: Actually, some tests (like src/vfs/extfs/helpers-list) don't use
<a id='L24' name='L24'></a>     this framework and will compile just fine. But that's the exception.
<a id='L25' name='L25'></a>[4]: http://stackoverflow.com/questions/1649814/debugging-unit-test-in-c-using-check
</pre>
<hr />
<a id='BOTTOM' name='BOTTOM'></a>
<em class='comment'>/* <img class='icon' src='../icons/n_left.png' alt='[previous]' /><img class='icon' src='../icons/n_right.png' alt='[next]' /><img class='icon' src='../icons/n_first.png' alt='[first]' /><img class='icon' src='../icons/n_last.png' alt='[last]' /><a href='#TOP'><img class='icon' src='../icons/top.png' alt='[top]' /></a><img class='icon' src='../icons/n_bottom.png' alt='[bottom]' /><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a>&nbsp;<input type='text' readonly onfocus='this.select();' value='+25 tests/README'  /> */</em>
</body>
</html>
